Skip to main content

Update Destination

Route

/v2/streaming/destinations/{destination.id}

Description

Update an existing streaming destination with the provided configuration.

Method

PATCH

Inputs

ParameterTypeRequiredDescription
destination.idstringYesThe unique identifier of the destination
namestringYesHuman-readable name for the destination
descriptionstringNoDetailed description of the destination
formatstringYesData format (json_lines, json)
typestringYesDestination type (https)
encodingstringNoData encoding (gzip, encoding_unspecified)
https_configobjectNoHTTPS destination configuration

Query Parameters

ParameterTypeRequiredDescription
fieldsstringNoSpecifies which fields to update

Request Body

{
"name": "Updated SIEM",
"description": "Updated security information and event management system",
"format": "json_lines",
"type": "https",
"encoding": "gzip",
"https_config": {
"uri": "https://new-siem.company.com/api/events",
"ignore_ssl_errors": false
}
}

Output

FieldTypeDescription
resourcesarray[Destination]Array containing the updated destination
errorsarray[Error]Any errors encountered

Rate Limit

  • 60 requests per minute per API key
  • 5 concurrent requests per endpoint

Example Response

{
"resources": [
{
"id": "dest-123",
"name": "Updated SIEM",
"description": "Updated security information and event management system",
"format": "json_lines",
"type": "https",
"encoding": "gzip",
"https_config": {
"uri": "https://new-siem.company.com/api/events",
"ignore_ssl_errors": false
}
}
],
"errors": []
}